ModifyScheduledTask
Description
modify the attributes of a scheduled task.
Request Method
POST
Request Path
/apsara/route/Ess/ModifyScheduledTask
Request Parameters Common Parameters
| Name | Location | Type | Required | Sample value | Description |
|---|---|---|---|---|---|
| Description | BODY | string | No | No sample value for this parameter. | description information of the scheduled task. 2-200 English or Chinese characters. |
| LaunchTime | BODY | string | No | No sample value for this parameter. | the time point at which the scheduled task is triggered. According to ISO8601 standards, UTC time is required. The format is: YYYY-MM-DDThh:mmZ. If a RecurrenceType is specified, the point in time specified by this attribute defaults to the point in time when the loop is executed. If no RecurrenceType is specified, it is executed once on the specified date and time. You cannot fill in the time after 90 days from the day of creation or modification. |
| ScheduledTaskId | BODY | string | Yes | No sample value for this parameter. | ID of the scheduled task. |
| RecurrenceType | BODY | string | No | No sample value for this parameter. | the type of scheduled task to be executed repeatedly. Optional value: Daily: how many days do you repeat the scheduled tasks. Weekly: Repeat the scheduled task every specified few days per week. Monthly: specify a few days each month to repeat the scheduled task. after modification, the RecurrenceType, RecurrenceValue and RecurrenceEndTime need to be valid at the same time. |
| ScheduledTaskName | BODY | string | No | No sample value for this parameter. | the display name of the scheduled task, 2-40 English or Chinese characters, starting with numbers, large and small letters or Chinese, and can contain numbers, "_", "-" or "." The same user account is unique in the same region. If this parameter is not specified, the default value is ScheduledScalingTaskId. |
| version | BODY | string | No | 2016-01-01 | version of api |
| LaunchExpirationTime | BODY | integer | No | No sample value for this parameter. | retry within this time after the scheduled task trigger operation fails. The default is 600 seconds. Value range:[0, 21600]. |
| regionId | BODY | string | Yes | No sample value for this parameter. | region id |
| ScheduledAction | BODY | string | No | No sample value for this parameter. | actions to be performed when a scheduled task is triggered. Enter the unique identifier of the scaling rule here. |
| RecurrenceValue | BODY | string | No | No sample value for this parameter. | the value of repeating the scheduled task. Daily: Only one value can be filled in, and the value range is:[1,31]. Weekly: You can fill in multiple values. Sunday, Monday... Saturday's values are: 0, 1,2,..., 6. Many days are separated by the English character. Monthly: format is A- B. The value range of A and B is [1,31] , and B must be greater than or equal to A. After modification, the RecurrenceType, RecurrenceValue and RecurrenceEndTime need to be valid at the same time. |
| RecurrenceEndTime | BODY | string | No | No sample value for this parameter. | the end time of repeated execution of scheduled tasks. According to ISO8601 standards, UTC time is required. The format is: YYYY-MM-DDThh:mmZ cannot be filled in 90 days after the day of creation or modification. After modification, RecurrenceType, RecurrenceValue and RecurrenceEndTime need to be valid at the same time. |
| TaskEnabled | BODY | bool | No | No sample value for this parameter. | whether to start a scheduled task. true: start task false: Stop task defaults to true. |
Return data
| Name | Type | Sample value | Description |
|---|---|---|---|
| The scheduled task name already exists. | invalidscheduledtaskname.duplicate | The specified value of parameter is duplicated. | 400 |
| the specified ScheduledAction does not match the region where the scheduled task is located. | scheduledaction.regionmismatch | The specified scheduled task and the specified scheduled action are not in the same Region. | 400 |
| the specified timing task does not exist under this user account. | invalidscheduledtaskid.notfound | The specified scheduled task does not exist. | 404 |
Example
Successful Response example
{
"The scheduled task name already exists.":"The specified value of parameter is duplicated.",
"the specified ScheduledAction does not match the region where the scheduled task is located.":"The specified scheduled task and the specified scheduled action are not in the same Region.",
"the specified timing task does not exist under this user account.":"The specified scheduled task does not exist."
}
Failed Response example
{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}
}